home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 July / macformat-026.iso / mac / Shareware City / Control Strip / Audio Strip GH 1.1 folder / Audio Strip GH -- Read Me < prev    next >
Encoding:
Text File  |  1995-01-23  |  9.3 KB  |  178 lines  |  [TEXT/ttxt]

  1.                                     Audio Strip GH v. 1.1
  2.                                                                                                                                                                                                 by
  3.                                                          Glenn R. Howes
  4. What it is:
  5.   Audio Strip GH is a collection of 11 Control Strip modules which implement the controls on a CD player: play, stop, eject, volume, pause/continue, fast forward, fast backward, skip to next  track, skip to previous track, display time and one module which does most everything. 
  6.   
  7.   It should work with any drive which uses Apple's CD-ROM driver (although, the volume control will not work with the CDSC drive). It does not work with some Toshiba drives as they are mounted on the SCSI bus until after the control strip modules are loaded. I assume that this limitation applies to some other non-Apple drives.
  8.  
  9. What does it cost:
  10.   Audio Strip was originally freeware, and the  original modules still are. The newer modules are stored in an encrypted archive. If you want to use these, you will have to send me $10 for the password (details below).
  11.  
  12. I would be happy to license  all the modules to drive makers, or resellers of the Control Strip.
  13. _________________________________________________________________
  14.  
  15. Changes since 1.0
  16.   • Got rid of silly button on button look of the modules Finder icons
  17.     (rebuild your desktop to see changes).
  18.   • Added Fast Forward, Fast Reverse, Next Track, and Previous Track modules,
  19.     I now emulate every commonly present CD control. The user of course should
  20.     feel no compulsion to use all or most of the modules.
  21.         • Added Time/Volume display module.
  22.   • Added "Auto Repeat CD" option to the omni module.
  23.   • Added "Auto Eject CD" option to the omni module
  24.   • Added multiple drive support to all modules.
  25.         • Added balloon help strings.
  26.      • Tracks that begin with "-" (n-dashes) will no longer show up as an unselectable
  27.      gray line.
  28.         •    Replaced numbered menu of volumes with a graphical sliding menu (with continuously 
  29.     changing volume).
  30.   • All modules now based on the same generic audio cd module code framework to
  31.      improve maintainability.
  32.   • Eject should no longer allow ejecting the drive when the file sharing bug is 
  33.      holding it captive.
  34.   • Added disk name to top of track list menu.
  35. _________________________________________________________________
  36.  
  37. How to install:
  38. First, you must have the Apple Control Strip loaded. It is part of the System 7.5 release. It is also available with a set of commercial utilities called PBTools. Men & Mice are  distributing a compatible product called "Desktop Strip" as shareware.
  39.   
  40. To extract the encrypted modules:
  41. The modules are stored in a self extracting Stuffit Deluxe archive. Double click on the "Encrypted Modules.sea" and you will be asked for a password, which you can obtain by sending me $10 U.S (see "Payment" below). Be sure to enter the password exactly as given.
  42.  
  43. For those concerned with screen space:
  44. Drag CD Omni GH into the "Control Strip Modules" folder inside your System folder and restart.
  45.   
  46. For those with plenty of screen space:
  47. Drag any combination of CD Volume GH, CD Play GH, CD Eject GH, CD Pause GH, CD Last GH, CD Next GH, CD Omni GH, CD Scan Down GH, CD Scan Up GH, CD Time GH or CD Stop GH into the "Control Strip Modules" folder inside your System Folder and restart. 
  48.  
  49.                                                                                                 **You don't have to install all the modules.**
  50.                                                                 ** I use the omni, eject, volume, time and next track modules.**
  51.   
  52.   If the modules find a valid Apple CD ROM drive on your primary SCSI chain, 
  53.   they will appear in your control strip.  
  54.  
  55. How to use:
  56. All modules: 
  57. Command clicking will bring up a menu which allows you to select which of the CD drives on the primary SCSI bus the module will be associated with. If you have more than one CD drive, you can make duplicates of modules and associate the duplicates with different drives.
  58.  
  59.  
  60. Omni module (3 icons:X, right triangle or 2 Rectangles; with mini icons on bottom):         
  61. Command clicking will bring up a menu with items:
  62.                            Auto Play CD:                  When selected, the module will try to play an audio cd on    insertion.
  63.                            Auto Repeat CD:      When selected, the module will keep playing the cd over and over.
  64.                         Auto Eject CD:                 When selected, the module will eject the cd when it finishes playing,  
  65.                                         unless it conflicts with auto repeating.
  66.             -------------------
  67.                                                 Drive 1, Drive 2... Choose which drive this module commands. You can make copies 
  68.                                                                                                                                                                 of this module so as to control multiple drives.
  69.                                
  70. If the cd is stopped, quickly clicking on the  triangle icon will start playing the audio cd                                                          from the beginning.
  71.                          
  72. If the cd is paused, quickly clicking on the triangle icon will continue playing from the paused position.
  73.                          
  74. If the cd is playing, quickly clicking on the double rectangles will pause the cd.
  75.                          
  76. If there isn't an audio cd in the drive, clicking and holding will bring up a menu with one item (eject).
  77.                          
  78. If you click and hold for a half second while playing, a menu will appear with a list of  tracks, an option to eject, an option  to pause or continue, and an option to stop. If you've used the Apple CD Player application to enter the track names, the menu will be in the form of track names, otherwise it wil be in the form of a list of track numbers. If you click and hold with the shift key down, only the track you select will be played.
  79.                          
  80. If you click and hold with the control key down, you will be given a menu from which to select a new sound level. (will not work on CDSC).
  81.                          
  82.       *** the omni & display modules asks the cd player for its state every 2 seconds***
  83.                                                       *** the other modules use up little computing time  ***
  84.  
  85.  
  86. Up + Down Triangles:   
  87.                 Clicking on this icon and holding will bring up a menu, which you can use to set the CD's sound level (wont work on CDSC).  
  88.                          
  89. Triangle:
  90. Clicking on this icon and holding will bring up a  menu of the possible tracks to start playing from. (if you hold down the shift key while selecting  a track, only that track will be played).   
  91.                          
  92. Square:
  93. Clicking on this icon will stop the cd's playing.  
  94.    
  95. Triangle + Rectangle:
  96. Clicking on this icon should eject the cd.(Command Click: select drive)   
  97. **warning: does not differentiate between audio & other CD's**.
  98.                             
  99. Verical Rectangles:   
  100. Clicking on this icon while a track is playing will put the CD into a pause state. Clicking again while in this state will continue playing from the original point.  
  101.                          
  102. Double Left Triangle: 
  103. Clicking and holding on this icon will do a fast rewind as long as the button is being pushed.  
  104.                             
  105. Double Right Triangle:
  106. Clicking and holding on this icon will do a fast forward as long as the button is being pushed.    
  107.                             
  108. 2 Left Triangles+ Rectangle:     
  109. Clicking on this button will go to the beginning of the previous track. 
  110.    
  111. 2 Right Triangles+ Rectangle:
  112. Clicking on this button will go to the beginning of the next track.    
  113.  
  114. Track + Time + Sound Level Display: 
  115. Clicking on this module will bring up a menu of times to display
  116. and which of the available disks to monitor:
  117.            menu item                                                                                        mini icon in display
  118.             Time Left in Track            ==>                 open circle + down arrow
  119.    Time Left in Disk                    ==>                    full circle + down arrow
  120.             Time into Track                            ==>                    open circle + up arrow
  121.          Time into Disk                                    ==>                    full circle + up arrow
  122.  
  123. In the upper left corner of this module, the current track is displayed
  124. in boldface. If the drive is stopped or an audio cd isn't present, there
  125. will be two n-dashes (--).
  126.  
  127. In the lower right portion of the module, the current playback time is
  128. displayed; which playback time is used depends on the settings of the 
  129. preference menu. If the drive is stopped or an audio cd isn't present, 
  130. "--:--" will be displayed.
  131.  
  132. On my system (U.S.A Roman), their is room for 5 small boxes over the
  133. time display, which are used to display the current sound level if the 
  134. selected drive supports software sound level control.
  135.  
  136. If assumptions I made about font sizes affects non-USA systems, please
  137. let me know.
  138.  
  139. ** caution: this module should use far and away the most CPU time **
  140. Payment:
  141.  If you want to use the modules in the encrypted archive, send me $10 U.S. + a self addressed, stamped postcard to:
  142.  
  143.   Glenn R. Howes
  144.   726 W. Main #301
  145.   Madison, WI 53715
  146.  
  147. If you send a valid, Internet-reachable, e-mail address, I will send the password that way, thus saving time.
  148.  
  149. Warranty:
  150.   There is none. Any damage caused by using this software is
  151.   the responsibility & problem of the user.
  152.  
  153. Report Bugs/ Feature Requests:
  154.  
  155.   
  156.   Internet: grhowes@students.wisc.edu
  157.   
  158.  
  159.  
  160. Look for:
  161.  My AppleScript Audio CD extension: AudioCDgh.
  162.  
  163. Written In:
  164.   C using the Codewarrior DR\5 release.
  165.   
  166. Thanks to:
  167.  My beta testers especially Troy Gaul who nagged me into the omni module.
  168.  
  169.  Leonard Roesenthol for pointing out the flicker free beauty of the srcCopy
  170. text mode.
  171.  
  172.  Martin Minow for providing the world with the controlstrip.h file, without which
  173.  writing these modules would be somewhat iffy.
  174.  
  175.  The good folks of Pious the X Grade School in Billings, MT, where I went to
  176.  1st -> 3rd grade. I hope you are still in business.
  177.  
  178.